home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
IRIX Base Documentation 1998 November
/
IRIX 6.5.2 Base Documentation November 1998.img
/
usr
/
share
/
catman
/
p_man
/
cat3
/
f90
/
pxfchown.z
/
pxfchown
Wrap
Text File
|
1998-10-30
|
3KB
|
81 lines
PXFCHOWN(3F) Last changed: 1-6-98
NNAAMMEE
PPXXFFCCHHOOWWNN - Changes the owner and group of a file
SSYYNNOOPPSSIISS
CCHHAARRAACCTTEERR*_n _p_a_t_h
IINNTTEEGGEERR _i_l_e_n,, _i_o_w_n_e_r,, _i_g_r_o_u_p,, _i_e_r_r_o_r
CCAALLLL PPXXFFCCHHOOWWNN((_p_a_t_h,, _i_l_e_n,, _i_o_w_n_e_r,, _i_g_r_o_u_p,, _i_e_r_r_o_r))
IIMMPPLLEEMMEENNTTAATTIIOONN
UNICOS, UNICOS/mk, and IRIX systems
SSTTAANNDDAARRDDSS
IEEE standard interface for FORTRAN 77
DDEESSCCRRIIPPTTIIOONN
On IRIX systems, this routine is in lliibbffoorrttrraann..ssoo which is linked by
default when compiling programs with the MIPSpro 7 Fortran 90 compiler
or when compiling programs with the --ccrraayylliibbss option to the MIPSpro
7.2 F77 compiler.
The PPXXFFCCHHOOWWNN subroutine uses the cchhoowwnn(2) function to change the owner
and group of a file.
The value of _i_o_w_n_e_r and _i_g_r_o_u_p indicates the new values.
When using the CF90 compiler or MIPSpro 7 Fortran 90 compiler on
UNICOS, UNICOS/mk, or IRIX systems, all arguments must be of default
kind unless documented otherwise. On UNICOS and UNICOS/mk, default
kind is KKIINNDD==88 for integer, real, complex, and logical arguments; on
IRIX, the default kind is KKIINNDD==44.
The following is a list of valid arguments for this routine:
_p_a_t_h Input character variable or array element containing the
name of a file.
_i_l_e_n Input integer variable containing the length of _p_a_t_h in
characters. If _i_l_e_n is zero, all trailing blanks are
removed before calling cchhoowwnn().
_i_o_w_n_e_r Input integer variable containing the integer value for the
owner.
_i_g_r_o_u_p Input integer variable containing the integer value for the
group.
_i_e_r_r_o_r Output integer variable that contains zero if the group and
owner of the file were changed or nonzero if PPXXFFCCHHOOWWNN did
not change the group and owner.
In addition to the errors returned by the cchhoowwnn(2) system call,
PPXXFFCCHHOOWWNN may return the following errors:
EEIINNVVAALL If _i_l_e_n is less than 0 or _i_l_e_n is greater than LLEENN((_p_a_t_h)).
EENNOOMMEEMM If PPXXFFCCHHOOWWNN is unable to obtain memory to copy _p_a_t_h.
EEXXAAMMPPLLEESS
subroutine test (iowner,igroup)
character*(12) path
integer ilen, iowner, igroup, ierr
path = 'testfile'
ilen = 0
call pxfchown(path,ilen,iowner,igroup,ierr)
if (ierr.ne.0) then
print *,'FAIL: error from pxfchown = ',ierr
else
print *,'PASS: No error from pxfchown = '
endif
end
SSEEEE AALLSSOO
cchhoowwnn(2)
_A_p_p_l_i_c_a_t_i_o_n _P_r_o_g_r_a_m_m_e_r'_s _L_i_b_r_a_r_y _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l, publication SR-
2165, for the printed version of this man page.